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Preface 

This dcxument provides the following information: 

• new and changed features 

• installation information 

• related documentation 

• problem descriptions and fixes 


NOTE The software code printed in the release notes title indicates the software 

product version at thetimeof release. Some product and operating 
system changes do not require changes to documentation; therefore, do 
not expect a one-to-one correspondence between these changes and 
release notes updates. 


Latest printing: August 1998 

This document resides online in the file 

/opt/CC/newconfig/RelNotes/CXX.release.notes. YoU Can print 
the online copy by using an ip command I ike the following: 

Ip —dprinter_name /opt/CC/newconfig/RelNotes/CXX.release.notes 
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New and Changed Features 


This chapter summarizes the new and changed features inciuded in the 
A.10.40 HP C++reiease. This chapter aiso iistsfeatures introduced in 
prior reiease versions grouped by the compiier version number. 


Version A.10.40 Features 

New and changed features in this H P C++version A.10.40 are iisted 
beiow. They appiy to H P-UX 10.x operating systems. 

• HP C++version A.10.40 is a maintenance reiease and inciudes oniy 
defect fixes. 

• Updated the Oniine Programmer's Guide and HP C++ 
Troubieshooting Notes to inciude new information on "Generating 
i nstantiation Fiies Without Compiiing." 


Version A.10.26 Features 

New and changed features in this H P C++version A.10.26 are iisted 
beiow. They appiy to H P-UX 10.x operating systems. 

New and Changed Features 

The new and changed features for A.10.26 are iisted beiow. 

• HP C-H-(cfront) no ionger indudes iibcodeiibs.a. HP C-I-+, however, 
inciudes the source for the H P Codeiibs Library. You must buiid the 
iibrary if you want to use it. The instructions for buiiding the iibrary 

are in /usr/contrlb/codelibs/README. 

• New Compiier Options +ESiit and +ESsfc. 
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New and Changed Features 

Version A.10.26 Features 


+Esiit Places string literals intothe $lit$ subspace. The 

$LiT$ subspace is used for read-only data storage. 
This option can reduce memory requirements and 
improve run-time speed in multi-user applications. 

Normally the compiler only places floating-point 
constant values in the $lit$ subspace, and other 
constants and literals in the $data$ subspace. 

+ESfic Replaces millicodecalls with inline fast indirect 

calls. The +ESfic compiler option affects how 
function pointers are dereferenced in generated 
code. The default is to generate low-level millicode 
calls for function pointer calls. 

The +ESfic option generates codethat calls 
function pointers directly, by branching through 
them. 


NOTE The +ESfic option should only be used in an environment where there 

are no dependencies on shared libraries. The application must be linked 
with archive libraries only. Using this option can improve run-time 
performance. 


• +p option identifies more source code constructs that may be issues 
when migrating to H P aC-l-h which supports ANSI C-H-syntax. 

• The +DA option changed so that if you specify +da and not +ds, the 
default instruction scheduling is based the +da option, not the type of 
system on which you are compiling. Refer to the online help for 
details about these two options. 

• Any programs that use +eh and also use Setjmp/Longjmp must 
change the #include from <set jmp . h> to <Set jmp . h>. 

• For task library users, iibV3 is no longer required, removing a 
limitation that existed in A.10.22. 
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New and Changed Features 

Version A.10.22 Features 


Version A.10.22 Features 

New and changed features in this H P C++version A.10.22 are listed 
below. They apply to H P-UX 10.x operating systems. 

• New +DA designations for PA-RI SC 2.0 model and processor 
numbers--to generate code for the PA-RI SC 2.0 systems. The 
+DAportabie option generates code Compatible acr OSS PA-RI SC 1.1 
and 2.0 workstations and servers. 

Default architecture object codegeneration is now determined 
automatically for all systems as that of the machine on which you 
compile. 

• New +DS designations for PA-RI SC 2.0 model and processor 
numbers-to perform instruction scheduling tuned for PA-RI SC 2.0 
systems. 

Default instruction scheduling is now determined automatically for 
all systems as that of the machine on which you compile. 

• New or changed optimization options to enhance performance: 

• +odataprefetch - to generate data prefetch instructions for 
data structures referenced within innermost loops. 

• +oentrysched - changing to make save and restore operations 
more efficient. 

• +ofaiisafe - to enable fail-safe opti mization by default. 

When a compilation fails at the current optimization level, 
+ofaiisafe will automatically restart the compilation at a lower 
level of optimization. 

• +ofitacc - changing to provide better performance for PA-RI SC 
2.0 targets. 

• +oiniinebudget-to perform aggressive inlining. 

• +oioopunroii - to enable loop unrolling. 

• +Ostaticprediction - to enable Static branch prediction. 

• New option -i library - to support the id feature. 


Chapter 1 
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New and Changed Features 

Version A.10.22 Features 


• New option -ptR -- to prevent re-instantiation of templates when 
compiling and linking from multiple directories and using the same 
repository, and to prevent out-of-date errors on secondary 
repositories. 

• New +ESfic option - to replace millicodecalls with inline code for 
fast indirect calls. 

• New +heip option - to invoke online help for the HP C-l-compiler and 
linker and libraries. 

• New -ext option - to enable extensions to H P C-H-functionality. At 
this timethe extension included is 64-bit integer data type 

(long long) support for HP C-H-applications that need to use large 
integers, such as large file systems databases. 

• New option +dup_static_removai - to reduce the size of 
executables and to enhance performance by removing duplicate inline 
member functions that were dropped out of line because they were too 
complex or too large. 

The default, +nodup_static_removai, does not remove duplicate 
static member functions. Look up this option in the C-H-Online 
Programmers Guidefor an example of when to use the default. 

• New default elimination of duplicate symbolic debug information - to 
reduce the size of object files and executables and to enhance 
performance. To prevent the elimination of duplicate symbolic debug 
information, use the option +xd. Thisoption may be needed if you 
havepxdb or xdb problems. 

• New Explicit Template I nstantiation feature - to substantially 
reduce the amount of time required to compile libraries for which 
large numbers of templates are instantiated. 

• Updated HP C-H-Troubleshooting Notes-to include new information 
in sections on "Explicit Template I nstantiation," "Directed and 
Automatic I nstantiation to Generate Needed Templates," and 
"Directed Template I nstantiation." 

• To reduce code size, inline functions are no longer included in debug 
information. If you want to debug inline functions, use the +d 
compiler option. 
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Installation Information 


Read this entire dcxiument and any other release notes or readme files 
you may have before you begin an installation. 

To install your software, runtheSD-UX swinstall command. It will 
invoke a user interfacethat will lead you through the installation. For 
more information about installation procedures and related issues, refer 
to "Managing HP-UX Software with SD-UX" and other README, 
installation, and upgrade documentation provided or described in your 
H P-UX 10.x operating system package. 

H P C-H-requires approximately 46 MB of disk space: 16 MB for the files 
in /opt/cc and 30 MB for DDE, Blink Link, and HP/PAK. Depending 
on your environment, you may also need documentation for other parts 
of your system, such as networking, system security, and windowing. 
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Installation Information 

Migrating to the UNiX System V Reiease 4 (V.4) Fiie System 


Mi grati ng to the U NIX System V Release 
4 (V.4) File System 

Two migration tools are provided for users. Either the system Upgrade 
Tools or the tlink_install script can be used to migrate from an H P-UX 
9.x system to an H P-UX 10.x system. 

If your system has UpgradeTools installed (/usr/sbin/upgrade 
exists), transition links are created automatically upon product 
installation. A method of removing these links is also provided. For more 
information on automatic transition links refer to your operating system 
upgrade documentation. 

If there are no Upgrade Tools on your system, you can usetheC-H- 
tiink_instaii Script asa migration aid to create symbol id inks for HP 
C-H-product executables and include files when migrating from HP-UX 
9.x locations to H P-UX 10.x locations. The script is located in 

/opt/cc/newconfig/tiink_instaii. Should you want to remove 
these links, use the script located in 

/opt/CC/newconf ig/unlink_install. These scripts must be 
executed by a super user. 

Note that to reverse your migration process, you must use the 
appropriate uninstall tool. That is, if links were installed using the 
system UpgradeTools, they must be uninstalled using the system 
UpgradeTools. If links were installed using the tiink_instaii script, 
they must be uninstalled with the uniink_instaii script. 
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Related Documentation 


Dcxiumentation for HP C++is described in the following sections. 


Online Documentation 

Xwindow users can invoke the HP C++Online Programmer's Guide in 
any of the foil owing ways: 

• Use the +heip option on the cc command line. 

The following online documentation is included with the H P C++ 
product: 

• To access the HP C++Online Programmer's Guide, use the command: 

cc +help 

If the +heip option does not work, ensure the environment variable 
DTHELPSEARCHPATH is Set. (It may not beset if you riogin to a 
system, for example.) If it is not set, use the foil owing command to set 
it: 


eval $(dtsearchpath) 

Ensure the lang environment variable is set, typically lang=c. 

Asa workaround, you can view the online help using the? icon on the 
HP CDE front panel or by using one of the following commands: 

/usr/dt/bin/dthelpview -helpVolume CXX 

or 

/usr/dt/bin/dthelpview -h /opt/CC/help/C/CXX.hv 

NOTE Users with character-based terminals or terminal emulators can use the 

charheip program to view or print the online help provided for C-H-and 
the linker. 

Tostart charheip enter the full pathname (or just charheip if 
/opt/iangtoois/bln is In your $PATH environment variable), and 
you will get a usage statement: 

$ /opt/langtools/bin/charhelp 

charheip: Usage: charheip {cc | CC | til \ Id I -helpVolume file} 
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Related Documentation 

Online Documentation 


For help with C++, for example, enter charheip cc and follow the 
menus for further direction. For more information, seethe man page for 
charhelp(l) (/opt/langtools/share/man/ must be in your MANPATH 
environment variable). 

• FI P-DDE Debugger Online FI el p 

Refer to the discussion on basic-style (not advanced-style) debugging 
of optimized code in the FI P/DDE debugger online help. 

• To access the FI P Linker and Libraries OnlineUser Guideusethe 
command: 

Id +help 

The FI P Linker and Libraries Online User Gui deonline guide replaces 
the manual Programming on FIP-UX. 

• FIP C-H-Templates Technical Addendum describes template 
implementation in FI P C-H-. You can access the addendum from 
within the FIP C-H-Online Programmer's Guide It is also available in 
the postscript file, / opt/CC/newconfig/IecDocs/templates . ps 
and in the ASCI I file, 

/opt/CC/newconfig/TecDocs/templates.ascii. 

• FIP C-H-Troubleshooting Notes focuses on methods of diagnosing and 
solving problems you may encounter. It contains a "troubleshooting 
matrix" and a list of tools aval I able online in the 

/opt/cc/contrib/Toois directory. 

The document is available online in the postscript file, 

/ opt/cc/newconflg/TecDocs/tools . ps, and In the ASCI I file, 

/ opt/CC/newconfIg/TecDocs/tools.ascii. YoU Can aCCeSS the 
ASCI I file from within the FI P C-H- Online Programmer's Guide 

• FIP C-H-ReleaseNotes isthisdocument. TheonlineASCII filecanbe 
found in /opt/cc/newconfIg/RelNotes/CXX.release.notes. 

• The FIP PA-RI SC Compiler Optimization Technology White Paper 
describes the benefits of using optimization. It is available in the 
postscript file, 

/opt/langtools/newconfIg/white_papers/optimize.ps. 

• Online manual pages for cc, c++fiit, nm++, gprof++, and the 
standard libraries (stream, task, complex, codelibs, and standard 
components) are provided under /opt/cc/share/man. 
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Related Documentation 

Online Example Source Files 


Online Example Source Files 

The H P C++product comes with the source files of examplesfrom the HP 
C++Programmer's Guide The example source files reside in the 

/opt/CC/cont rib/Examples directory. 


Printed Documentation 

• HP C++Release Notes is this document. Release notes are also 
provided online, as noted above. 

• HP C++Programmer's Guide (92501-90005) contains similar, but in 
some cases less current, information to that of the H P C-H-Online 
Programmer's Guide 

• Quick Rd'erenceCard (B1637-90001) 

• HP/ DDE Debugger User's Guide contains information on debugging 
programs with the HP Distributed Debugging Environment on the 
HP 9000. (B3476-90015) 

To order printed versions of Hewlett-Packard documents, refer to 

manuals(5). 
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Related Documentation 

Hewlett-Packard Information on the Internet 


Hewlett-Packard Information on the 
I nternet 

Hewlett-Packard provides several sources of product documentation on 
the internet. 

HP Web Site 

The Hewlett-Packard web site, URL: http://www.hp.com, contains 
several areas with useful information about HP C-H-. 

• URL: http://www.hp.com/go/hpc-l-l- 

General product information, news, and ordering information. 

• URL: http://docs.hp.com/hpux/development/ 

This area contains links to most of Hewlett-Packard's HP-UX 
documentation, including compilers and development tools. You can 
view and search for information online. 

HP C++Mailing List Server 

For general background information and experience, subscribe to the 
cxx-dev list server. Send a message to ma jordomo@cxx. cup. hp. com 
with the following command in the body of the message: subscribe 
list-name. 

Available list-names are as follows: 

cxx-dev HP C-H-Development Discussion List 

cxx-dev-announce H P C-H-Development 

Announcements 

cxx-dev-digest HP C-H-Development Discussion List 

Digest 

cxx-dev-announce is also broadcast to cxx-dev, SO you Only need to 
subscribe to one of the lists. The digest also includes both cxx-dev and 
cxx-dev-announce. 
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Related Documentation 

Other Printed Documentation 


For additional help or information about the list server, send a message 
toma jordomo@cxx. cup. hp. com with the foil Owing command in the 
body of the message: help 


Other Printed Documentation 

Some of the many available C++publications are listed here: 

• Codelibs Library Rd'erence(B2617-90600) complete information on 
the HP Codelibs class library. This book can be ordered by contacting 
your local HP sales office or Hewlett-Packard's Support Materials 
Organization (SMO) at 1-800-227-8164 and providing the above part 
number. Also see the codelibs(3X) man page. (If you seethe message 
Man page could not be formatted or No manual entry for 
codelibs ensure that the man page is installed and your manpath 
variable includes /opt/contrib/man.) 

• TheC-H-Programming Language second edition, by Bjarne 
Stroustrup (I SBN 0-201-53992-6) is a tutorial on C-H-including a 
complete language reference manual and information about 
object-oriented design and software development. This book is 
available at technical bookstores. 

• C-H-Primer, second edition, by Stanley Lippman (I SBN 
0-201-54848-8) provides a complete tutorial introduction to C-H-. This 
book is available at technical bookstores. 

• TheAnnotated C-H-Rd'erenceManual, by Margaret Ellis and Bjarne 
Stroustrup (ISBN 0-201-51459-1) is a complete C-H-language 
reference manual plus annotations and commentary that describe in 
detail why features are defined as they are. This book is available at 
technical bookstores. 

• The HP PA-RI SC Compiler Optimization Technology White Paper 
(5963-7250E) describes the benefits of using optimization. To order a 
pri nted copy, contact your local H P sales office or H P Dl RECT at 
1-800-637-7740. The white paper is also provided online as noted 
above. 

• USL/NovelI/SCO manuals contain valuable information about C-H-, 
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Related Documentation 

Information on Exception Handling Features 


some of which is specific to the cfront compiler upon which H P C++is 
based. 

Toinquireaboutthelatest versions of these manuals, you can contact 
the foil owing: 

• U.S. customers--phone 1-800-336-5989 

• International customers-FAX 1-(801) 431-4060 

• You can send e-mail requests to: sco_unix(gstream.com 

• You can alsouseURL: http://www.modusmedia.com/sco_doc/toget 
more information about aval I able document at ion. 


Information on Exception Handling 
Features 

Below is some valuable information on exception handling features 
published in previous release notes. 

Exception handling is supported in both compiler mode and translator 
mode, and such object files can be intermixed. Use the 4eh option to 
enable exception handling for both compiling and linking. There is some 
performance degradation when using the -feh option in translator mode. 

Detecting Link Incompatibilities when Using 
Exception Handling 

This release of H P C-H-supports exception handling when the -feh option 
isspecified. Notethat codecompiled with -teh is not link compatible with 
code that has not been compiled with -feh. There are three reasons for 
this: 

1. When -feh is enabled, constructors no longer allocate memory for 
heap objects; such memory is allocated before the constructor is 
called. For example, if non -feh code calls a -feh constructor to 
construct a heap object, memory for the heap object is not allocated. 

2. When -feh is enabled, all constructors perform a certain amount of 
bookkeeping to indicate how far object construction has progressed; 
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Related Documentation 

Information on Exception Handling Features 


this is needed because in the event of an exception, partially 
constructed objects need to be cleaned up. If 4€h code calls a non 4eh 
constructor, this bookkeeping does not take place; thus, in theevent of 
an exception, there is incorrect information about the state of objects 
in procedures which called non 4€h constructors. 

3. All 4€h procedures perform a certain amount of bookkeeping to save 
information about the list of objects constructed within each 
procedure. Since non 4€h proc^ures do not perform this 
bookkeeping, such procedures do not undergo any object cleanups in 
the event of an exception. 

Detecting Link Incompatibilities in Shared 
Libraries 

When theCC driver is used to produce a shared library (using-b), link 
i ncompati bi I ities are detected by c++patch usi ng the same rules 
described above. When performing a link which involves shared 
libraries, HP C++waits until run time to establish that each shared 
library linked in or explicitly loaded is compatible with the main 
executable. If any incompatibilities are detected, the default behavior is 
to print a warning message to stderr. If this default behavior is 
unacceptable, you can override it by linking in your own version of the 
routi ne_ link_incompatibility. 

For example, if you do not wish to have any warning of this kind at all, 
the foil owing routine can be linked in: 

extern "C" void _link_incompatibility 

(const char* libname, int lib_mode) { 

//libname is the name of the library 
//lib_mode == 0 for a non +eh library 
//lib_mode == 1 for a +eh library 

//You can provide your own version to override the 
//default behavior 

//This is an empty body which does nothing 


Exception Handling Language Clarifications 

This section lists various exception handling language issues which 
should be considered clarifications of The Annotated CT+Rd'erence 
Manual. These clarifications represent the behavior of H P's 
implementation of exception handling. 
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Related Documentation 

Information on Exception Handling Features 


Issues in this section are organized as follows: 

• Throwing an Exception 

• Handling an Exception 

• Throw Specifications 

• terminate 0 and unexpected() 

• Other Issues 

Throwing an Exception 

1. Can a class with an ambiguous base class be thrown? That is, 
should the following be legal? 

struct A { ... ); 

struct B1 : A { ... }; 
struct B2 : A { ... }; 
struct C : Bl, B2 { ... }; 

void f() 

{ 

C c; 

throw c; // legal? 

} 

No, throwing a class with an ambiguous base cl ass is not legal. 

2. Can a class with multiple instances of the same base class be 
thrown if only one of the base class instances is accessible? 

No, a cl ass with multiple instances of the same base class cannot be 
thrown even if only one of the base class instances is accessible. 

3. What happens when a reference is thrown? 

A temporary is allocated, the object referenced by the throw 
argument is copied into the temp, and the search for the appropriate 
handler is begun. 

When the handler is found, if its argument is not a reference type, the 
local is initialized from thetemp. If the handler's local variable is of a 
reference type, the reference is made to refer to the temp. 

The possiblysurprising effect of thisisthat if a referenceto a global is 
thrown, and the handler's local is a reference type, the handler gets a 
reference to the temporary, not a reference to the global. 

4. Can the name of an overloaded function be thrown? 
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No, the name of an overloaded function (really, its address) cannot be 
thrown. 

5. What is the precedence of throw? 

A throw-expression is an assignment-expression. 

6 . Can a throw appear in a conditional expression? For example, 
is the following legal? 

void f() 

{ 

int x; 

X ? throw : 12; 

} 


void g() 

{ 

int x; 

X ? 12 : throw; 

} 

Yes, a throw can appear in a conditional expression. 

7. Are nested throws allowed? 

Yes. When a nested throw occurs, processing of the previous exception 
is abandoned and the new exception is processed. 

8 . What happens if a rethrow occurs outside the dynamic 
context of a handler? 

The behavior of a rethrow outside the dynamic context of a handler is 
undefined. 

9. What happens if an exception is thrown in a signal handler? 

Throwing an exception in a signal handler is not supported. There is 
no way to predict when a signal handler will execute, consequently 
the signal handler could be called when the exception handling 
structures are in an inconsistent state. 

10. What happens if a longjmp is issued in a signal handler? 

This is not recommended for the same reason that throwing an 
exception in a signal handler is not supported. The signal handler 
interrupts processing of the code resulting in undefined data 
structures with unpredictable results. 
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Related Documentation 

Information on Exception Handling Features 

Handling an Exception 

1. Should the implementation warn or generate a hard error for 
the appearance of a masked catch clause? 

The appearance of a masked catch clause is an error. 

2. Does the presence of a linkage specification affect the 
handlers that can catch (the address of) a function? 

No, the type of a function is not affected by a linkage specification. 

For example, this throw: 

extern "C" { 
void f(int); 

}; 

void g() 

{ 

throw f; 

} 

is catchable by; 
catch (void (*) ()) 

3. Can an incomplete type appear in a catch clause? 

No, an incomplete type cannot appear in a catch clause. 

4. When is an exception considered handled? 

An exception is considered handled when one of the following occurs: 

• a handler for the exception is invoked 

• terminate is invoked 

• unexpected is invoked 

Throw Specifications 

1. Must all throw specifications on the definition and 
declarations for a given function agree? 

Yes, all throw specifications on the definition and declarations for a 
given function must agree. 

2. Can a class with ambiguous base classes be on a specification 
list? That is, is the following throw specification on bar legal? 
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struct A { ... }; 

struct B1 : A { ... }; 
struct B2 : A { ... }; 
struct C : Bl, B2 { ... }; 

void too (C* cp) 

{ 

w *cp; //error according to ANSI 
} 


void bar () throw(C); // legal? 

No, a class with an ambiguous base cl ass cannot appear in a throw 
specification. 

3. Can a derived class of a class on a throw specification list also 
appear in that same throw specification list? 

Yes, a derived class of a class on a throw specification list can also 
appear in that same throw specification list. 

4. Can a function that lists a pointer to a base class in its throw 
specification list also throw a pointer to a derived class of that 
class? 

Yes, a function that lists a pointer to a base class in its throw 
specification list can throw a pointer to a derived class of that class. 

5. Can a reference appear in a throw specification list? 

Yes, a reference can appear in a throw specification list. 

6 . Can a type appear more than once in a throw specification 
list? 

That is, is the following declaration legal? 

void baz() throw(A,A,A); // legal? 

Yes, duplicate types are allowed in throw specification type lists. 

7. Can an incomplete type appear in a throw specification list? 
For example, should the following be legal? 

struct A; 

void f() throw(A) { } 

Yes, an incomplete type can appear in a throw specification list. 

8. Where can a throw specification appear? 

A throw specification can appear only in a function declaration or a 
function definition and only for thefunction being declared or defined. 
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I n particular, it can not appear within an argument list nor in a 
typedef. 

terminateO and unexpectedO 

1. What should be done when a thrown exception is not 
handled? 

No cleanups should take place; terminate should be called. 

If an unhandled exception occurs while constructing static objects, 
call terminate. If terminate then calls exit, any fully constructed or 
partially constructed statics should be destroyed. 

If an unhandled exception occurs while destroying static objects, call 
terminate. If terminate then callsexit, try to destroy any remaining 
static objects. Do not try again to destroy the object that caused the 
exception. 

2. Can terminateO call exit()? 

Yes, terminateO can call exit(). 

3. Can unexpectedO return? 

No, unexpectedO cannot return. 

4. Can unexpectedO throw or rethrow? 

Yes, unexpectedO can throw or rethrow. 

5. What does unexpectedO rethrow? 

A rethrow in unexpected!) rethrows the exception that caused 
unexpectedO to be called. 

Other Issues 

1. Are transfers of control into try blocks and handlers legal? 

No, transfers of control into try blocks and handlers are not legal. 

2 . Is it correct to consider an object constructed when its last 
statement is reached, while a destructor is considered 
complete just before its first statement is reached? 

An object is not considered fully constructed until everything in the 
constructor is finished. An object is considered partially destroyed 
before anything happens in the destructor. 
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3. Should the E H run-time delete memory allocated by a 
new-with-placement? 

No, the EH run-time should not delete memory allocated by a 
new-with-placement. 

4. Should locals and globals be cleaned up when an 
unhandleable exception is thrown? 

No, locals and globals are not to be cleaned up when an unhandleable 
exception is thrown. 

5. Should an object for which a destructor has been called still 
be cleaned up by the E H run-time? 

A destructor should not be called explicitly on an object for which a 
destructor iscalled implicitly. Thus the EH run-time should not have 
to worry about whether an explicit destructor call has been issued for 
an object. 

6 . Should exitO throw a standard exception to ensure that 
automatics are cleaned up? 

No, exitO should not throw an exception. 

7. What should happen when an exception is thrown from a 
function registered with atexitO? 

When an exception is thrown from a function registered with atexitO, 
terminateO should be called. 

8. What should happen if the user program calls allocaO? 

You can only use allocaO in translator mode. However, it is 
recommended that you avoid this function. 
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Problem Descriptions and Fixes 
and Known Limitations 


This chapter summarizes the known probiems and iimitations of the 
current version of H P C++, except as otherwise noted. 

Note: Since HP-UX 10.10 is the iast supported OS for PA-RiSC 1.0 
architecture machines, the 10.20 compiiers no ionger support the 
compi i i ng of code for PA-Ri SC 1.0. 


Known Problems 

For a iist of H P C-H-probiems and their fixes, see theTechnicai 
Knowiedge Database on the HP Eiectronic Support Center web site at: 

http://us-support.external.hp.com/ 

http://europe-support.external.hp.com/ 

TheTechnicai Knowiedge Database is avaiiabie to customers with 
support contracts. 

Step 1. Once at the web site, enter your User i D and Password, then ciick Okay. 

Step 2. On the next page, ciick Technical Knowledge Database. 

Step 3. Verify that your Search Options inciude H PUX under System Type 
and Service Request under Document Type. 

Step 4. Enter HPCPLUSPLUSA in the Search String fieid, then ciick Search to 
show a iist of probiems and any fixes. 

To verify the product number and version for your H P C-H-compiier, 
execute the foii owing HP-UX commands: 


what /opt/CC/lbin/cfront 
what /opt/CC/bin/CC 



Problem Descriptions and Fixes and Known Limitations 

Binary Compatibility 


Binary Compatibility 

An application that ran on previous HP-UX 10.x releases (10.01, 10.10, 
or 10.20) generally will continue to run with the same behavior with this 
10.20-basecl HP C-H-release provided that any dependent shared 
libraries are also present. 

An executable is a binary file that has been processed by the HP linker 
with Id or indirectly with the compiler, and can be run by the H P-UX 
loader(exec). 

When you compile your source code without any changes (to source code, 
options, or makefiles), and you usePBO (+i compiler or linker option) or 
the +04 option during development, you may create instrumented objects 
(I SOM) that a previous system does not recognize. 


NOTE This code may not be backward-compatible with previous 10.x releases. 

I n general, you cannot move instrumented object files backward. 


If you move an I SOM across operating system versions, for example, 
from an 11.x system to a 10.x system, you may receive the following 
error: 

Error at line 0: Backend Assert ** Ucode versions earlier then v.4 
no longer supported. (5172) 
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Known Limitations in Version A.10.40 - A.10.26 


Table 4-1 


Known Limitations in Version A.10.40 - 
A.10.26 

Someof these limitations with possible workarounds are discussed in 
detail elsewherein this document. Please be aware that someof these 
limitations are platform-specific 

Thesetjmp/longjmp and -feh option 

Codecompiled in compiler mode with the-Feh option should not use 
setjmp/longjmp. Tousesetjump/longjmp with -Heh in translator mode, 
replace all setjmp/longjmp calls with Setjmp/Longjmp. You must also 
must change the #include from <set jmp.h> to <Set jmp.h>. 


Thread-safe levels 

The thread-safe level of the code generated by H P C-F-Fdepends on which 
libC routines are called with the possible except!on of static constructors 
for function scope statics or -Feh code. 

Thread-safe levels depends on the type of interface. 

Thread-safe Levels 



User Threads 

Generated Code: 

Function-scope 

statics 

Thread-Restricted C. User owns the local 
variable. 

File-scope static 
and globals 

Thread-Restricted C for dynamic loading of 
shared libraries. Ordering of initialization may 
be more of a problem. 

+eh code 

Thread-Safe Performance Constrained. 

libc interfaces: 

-Feh ([rejthrow) 

Thread-Safe Performance Constrained. 
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Known Limitations in Version A.10.40 - A.10.26 



User Threads 

I/O (iostreams, 
strstream, etc) 

Thread-Safe Performance Constrai ned. Tuned if 
using predefined streams: cin, cout, cerr, 
clog. OtherwiseThread-Restricted C. You must 
compileyour program with -d _thread_safe. 

vec new/delete 

Thread-Safe Performance Constrained. 

cxxshl_load 

and 

cxxshl_unload 

Thread-Restricted C. 

Others 

Probably references no statics/globals so 
completely safe, iibc is not fork-safe. It 
assumes no cancellations are possible. 
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Known Problems and Limitations in Version A.10.22 


Known Problems and Limitations in 
Version A.10.22 

Someof these limitations with possible workarounds are discussed in 
detail elsewherein this document. Please be aware that someof these 
limitations are platform-specific 

Non-Derived Class Access to a Protected 
Constructor from Another Class 

The HP C-H-A. 10.22 compiler incorrectly allows non-deri ved classes to 
access a protected constructor from another class. For example, the 
following code should generate a compiler error, but it does not. 

class A 
{ 

protected: 

A() { ) 

}; 

class B 
{ 

public: 

B 0 

A a; // This line should generate the error: 

// B::B() cannot access A::A(): protected member (1299) 

// but it does not. 

); 


Known Limitations in Version A.10.22 

• HP C-H-does not support large files (i.e., greater than 2 GB) with 
<iostream.h>. 

• For task library users, both libtask and libV3 are required. When 
linking, use-itask -1V3 on thecc command line. This limitation is 
removed in later versions of H P C-H- 

• Known limitations of profile-based optimization: 

• +p is incompatible with debug (-g, -gi), static analysis (-y), 
exception handling (+eh), assembly only mode (-s), and +i. 
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Problem Descriptions and Fixes and Known Limitations 

Known Problems and Limitations in Version A.10.22 


• +i is incompatible with debug (-g, -gi), static analysis (-y), 
exception handling (+eh), assembly only mode (-s), profiling (-g), 
stripping (-s), and +p. 

• Known limitations of exception handling features: 

• Codecompiled in compiler mode with the+eh option should not 
usesetjmp/longjmp. Tousesetjump/longjmp with +eh in 
translator mode, replace all setjmp/longjmp calls with 
Setjmp/Longjmp. For example: 

#include <stdio.h> 

#include <setjmp.h> 

Jmp_buf jb; 

struct A { 

int X; 

A (int i) (x = i; } 

~A() {printf("A::~A[%d]\n", x) ; } 

); 

void g() 

{ 

A a (1) ; 

Longjmp(jb, 1); // longjmp replaced by Longjmp 

) 

void f() { 

int X; 

if (Setjmp(jb) == 0) // setjmp replaced by Setjmp 

go ; 

X = 37; 

) 


void main() { 

try { 

f 0 ; 

printf ("about to throw 97\n"); 
throw 97; 

) 

catch (int i) { 

printf("caught int\n"); 

) 

) 


The restrictions are: 

• A setjmp site can be returned to only through a longjmp; a 
Set jmp site can be returned to only through a Longjmp. 
Results are otherwise undefined. 

• Behavior is undefined for a longjmp from a destructor called 
during object cleanup. 
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Problem Descriptions and Fixes and Known Limitations 

Known Problems and Limitations in Version A.10.22 


• C modules that used setjmp/longjmp can be linked with C++ 
code that uses Setjmp/Longjmp with +eh provided that noC++ 
codecompiled with +eh is invoked between a call toset jmp 
and the last long jmp executed to that set jmp location. 

• If an unhandled exception is thrown during program initialization 
phase (that is, before the main program begins execution) 
destructors for some constructed objects may not be run. 

• I nhi biting of auto-destructors on the throw and catch statements in 
the symbolic debugger is not supported. 

• If you compile tempi ate files across nfs mounts and you see that 
c++ptcomp or c++ptiink is idling while waiting to lock the 
repository, you must verify that /usr/sbin/rpc. lockd and 
/usr/sbin/rpc. statd are running on both systems. The locking 
scheme used by c++ptiink and c++ptcomp depends on the rpc (30 
mechanism. 

• When using the task library, you must not compile your application 
sources with the-o flag. Instead, usethe+oi flag to get a smaller 
subset of optimizations. It is necessary to disable some optimizations 
for the task library to work properly. 

• Symbolic debugging information is not always emitted for objects that 
are not directly referenced. For instance, if a pointer to an object is 
used but no fields are ever referenced, then FIP C++only emits 
symbolic debug information for the pointer type and not for the type 
of object to which the pointer points. 

For instance, use of widget * only emits debug information for the 
pointer type widget * and not for widget. If you wish such 
information, you can create an extra source file which definesa 
dummy function that has a parameter of that type (widget) and link 
it into the executable program. 

• Source-level debugging of C-H-shared libraries is supported on 
FIP-UX 9.0 and 10.x. FIowever, there are limitations related to 
debugging C-H-shared libraries, generally associated with classes 
whose member functions are declared in a shared library, and that 
have objects declared outside the shared library wherethe class is 
defined. Refer to the appropriate release notes and manuals for the 
operating system and debugger you are using. 

• I nstantiation of shared objects in shared memory is not supported. 
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Known Problems and Limitations in Version A.10.22 


• Linking with the -r option is not supported for applications that use 
templates. See "Renaming Object Files" in chapter 5 of H P C++ 
Templates Technical Addendum. 

• When you call the shi_ioad (3) routines in libdid. si either 
directly or indirectly (as when your application calls setiocaie (3) 
or iconv(3) ), and you use the +a option, you will get an "unresolved 
externals" error. 

If you want to link archive libraries and iibdid. si, use the -wi,-a, 
archive option. The following example directs the linker to use the 
archive version of standard libraries and (by default) iibdid. si. 

CC prog.o -Wl,-a,archive 

• When using templates, if the declaration of a template class function 
is not inlined and the definition is inlined and the function is used 
before it is defined, H P C++no longer generates a compiler error. I n 
this case, H P C++ignores the inline keyword in the definition. 

template <int i> class A { 
public: 

//declaration of foo function 
void foo(); 

}; 


main () 

{ 

A<1> a; 

//use of foo function before definition 
a . foo(); 

} 


//definition of foo function 

template <int i> inline void A<i>::foo() { } 

I n H P C++ releases prior to A.10.0, the above example generated the 
following compiler messages: 

CC -c p.c 

CC: "p.c", line 21: warning: a used but not set (116) 

CC: "p.c", line 26: error: A <1 > ::foo() declared with 
external linkage and called before defined as inline (1144) 
"p.c", line 26: error detected during the instantiation ofA <1 

> 

"p.c", line 29: is the site of the instantiation 

H P C++version A.10.22 generates only the following warning: 

CC -c p.c 
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Known Problems and Limitations in Version A.10.22 


CC: "p.c", line 21: warning: a used but not set (116) 

Although currently no syntax error is generated, an error may be 
generated in future releases of H P C++. This may be a consideration 
when porting from the current HP C++to a future version. 

Note that in the normal case, function foo would be declared and 
defined before it is used. 

• Thevfork(2) system call is a "fast" version of fork (2) , in which 
the parent process is suspended until the child does an exec. During 
this time, the child uses the parent's memory segment, thus avoiding 
the overhead of creating its own. See man page for fork (2) and 

vfork (2). 

In an eh program, when the child defines an automatic destructable 
object and does an exec beforethat object goes out of scope, the global 

variable_ eh_dt_count, used in managing eh at runtime, becomes 

corrupted. This may lead to runtime eh errors during a throw. 

• Using shi_ioad (3X) with Library-Level Versioning 

Once library-level versioning is used, calls to shi_ioad o (see 
shi_ioad{3X) ) should specify the actual version of the library that 
is to be loaded. 

For example, if libA. si is now a symbolic link to iibA. i, then calls 
to dynamically load this library should specify the latest version 
available when the application is compiled, such as: 

shl_load("libA.1", BIND_DEFERRED, 0); 

This will insure that, when the application is migrated to a system 
that has a later version of libA available, the actual version desired 
is the one that is dynamically loaded. 


NOTE For C-H-shared libraries, cxxshl_load should be used instead of 

shl_load(3X). 

• Use of the option +dup_static_removai may give you the linker 
error: Common block requests for functlonname have 
different lengths. Update the linker by applying the most recent 
patches to fix this problem. 


Chapter 4 


35 




Problem Descriptions and Fixes and Known Limitations 

Known Problems and Limitations in Version A.10.22 


If you do not have the latest linker patches, you will get this error in 
one of two cases. One, your code violates the C++ requirement that 
"all inline member functions with the same name must also have the 
same body." Two, you use different compiler options to compile the 
duplicate inline member functions of different compilation units. 

Library providers who ship header files may not want to use 
+dup_static_removai because they do not know if their users 
compile with the same options as they do. 
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